CASE_PRESERVE Function

Syntax

Preserved_String as C = CASE_PRESERVE(C string)

Arguments

string: A character string.

Description

Returns a string + the case information.

Discussion

CASE_PRESERVE() returns the original Input_String with an appended hexadecimal code that indicates which characters of the Input_String are upper case. The appended code has sufficient bits to represent each character of the Input_String as 1 (upper case) or 0 (lower case). The most significant bit is to the left. The following illustration shows how the algorithm works. Note : CASE_PRESERVE() allows you to distinguish between upper and lower case versions of strings when using functions that are not case sensitive.

Algorithm: Result
Input_String: Alpha Software
Parsed into 4 character segments: Alph|a So|ftwa|re
Binary representation of upper case characters: 1000|0010|0000|0000
Hexadecimal representation of upper case characters: 8 |2 |0 |0
Preserved_String Alpha Software: 8200

Example

case_preserve("Edward")   ->   "Edward80"
case_preserve("EDWArd")   ->   "EDWArdF0"
case_preserve("Alpha Software")   ->   "Alpha Software8200"